home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / bbs / poker21.zip / POKER-BN.DOC < prev    next >
Text File  |  1997-06-17  |  22KB  |  521 lines

  1.  
  2.                    * * *  P O K E R  B A N D I T * * *
  3.                  Copyright 1993 - 1997 by M & S Software
  4.  
  5. Poker Bandit Version 2.1
  6. 6/18/1997 by M & S Software
  7.  
  8. Author: Mike Jordan    
  9. Main Screen Graphics: Pat Weiler
  10.               
  11. Built in BBS Support For: 
  12.  
  13.   Wildcat! BBS 3.X, 2.X, 1.13       PCBoard BBS 14.X           QuickBBS
  14.   Remote Access                     Spitfire BBS               GAP BBS
  15.   RBBS-PC BBS                       T.A.G. BBS                 Searchlight
  16.   (and any others that use the same drop file as these)
  17.  
  18. *** Game Description ***
  19.  
  20. Poker Bandit is like Poker in a Slot Machine.  Place your bet and pull the     
  21. handle then watch the cards spin.  Your payoff is based on how good of a
  22. "hand" you get.  The better the hand the better the payoff. Assuming you    
  23. get a payoff <grin>.  Poker Bandit it fun, fast and easy to play as well as
  24. addictive.
  25.  
  26.  
  27. *** Warranty ***
  28.  
  29. This product is provided "as is" without warranty of any kind. The entire
  30. risk as to the results and performance of the program is assumed by you.
  31. Furthermore, the author does not warrant, guarantee, or make any representa-
  32. tions regarding the use of, or the results of the use of the program, and you
  33. rely on the program and results solely at your own risk. The author cannot
  34. accept responsibility for system damage, loss of profit, or any other special,
  35. incidental, or consequential damages resulting from the use of or inability to
  36. use this product.  
  37.  
  38. *** Licensing ***
  39.     
  40. Upon registering you are granted a licensed POKER-BN.KEY, which gives you
  41. certain limited rights to use Poker Bandit.
  42.  
  43. You are granted the use of Poker Bandit on a single BBS System. 
  44. It may be used on several CPUs in a Networking or Multi-Tasking environment 
  45. where the BBS System has more than one physically connected node (i.e. 
  46. LAN Network).
  47.  
  48. You do not become an owner of Poker Bandit.  M & S Software retains 
  49. all rights to the software, copies of the software and related 
  50. materials. Also upon registering, you agree to use reasonable efforts to 
  51. protect the registered POKER-BN.KEY file from unauthorized use, reproduction 
  52. and distribution.  All rights not specifically granted in this license are
  53. reserved by M & S Software.
  54.                                                          
  55. Failure to comply with this License can result in termination of the
  56. License without refund.
  57.  
  58. *** Shareware Version - No Set Demo Period - Please Read ***
  59.  
  60. This door game is distributed under the SHAREWARE concept.  This
  61. concept gives you the chance to "try before you buy", and see if it
  62. meets your needs.  
  63.  
  64. I've decided to break away from the standard "30 day trial period"
  65. that many door authors are using and instead go to a much simpler 
  66. and more realistic policy. This is simply; Try it on your BBS.
  67. If you like it and your users like it, then register it.  If it's not 
  68. good enough to register, then delete it.  
  69.  
  70. While I'd like you to register my doors as soon as possible, I'm also 
  71. realistic enough to know that different boards have different requirements, 
  72. and interests, and sometimes it takes longer for a game catches on, or a 
  73. sysop can get to the Doors on his list to register.  And frankly, I'd rather 
  74. you ran it for awhile and register, than try it for a short period of time 
  75. and delete it. Nobody wins that way...I lose out on a registration and your 
  76. users lose out on the chance of having the registered door to play.
  77.  
  78. *** Three Ways To Run Poker Bandit ***
  79.  
  80. 1.  Running Locally:
  81.   
  82. To run locally you must first create a POKER-BN.CFG file.  To create this file
  83. run POKER-BN SETUP and fill in the fields that are presented. The .CFG file can
  84. also be created or edited with any ASCII editor.  See the example POKER-BN.CFG
  85. file for the lines required.  
  86.  
  87. Once the POKER-BN.CFG file is created go to the DOS prompt and type:
  88.                          
  89.         POKER-BN POKER-BN.CFG LOCAL
  90.  
  91. By specifying the configuration file the game will use the Sysop's real
  92. name instead of the name "Sysop".  It will also use the other parameters
  93. in the POKER-BN.CFG file that are active with the non-registered version.
  94. If the registered POKER-BN.KEY is present then all parameters will be
  95. active.
  96.  
  97. 2.  Running in Evaluation Mode:
  98.  
  99. Poker Bandit does not need a Demo Key to run in evaluation mode.  Create a 
  100. POKER-BN.CFG and setup as described later in this documentation and you are
  101. all set.  The evaluation mode will give you all the features of the 
  102. registered version EXCEPT that Bulletins will not be created, the multi-node
  103. option will not function (it will still work on a multi-node BBS but two 
  104. callers can not play Poker Bandit at the same time) and the dedication line will 
  105. not be implemented. In addition the game will reset the score board every 21 
  106. days (the reset at the 1st of each month is normal) and continue as if it was 
  107. the first of the month.
  108.  
  109. 3.  Running as a Registered Door:
  110.  
  111. You must have the Registration Key to run as a registered door. To register 
  112. simply print-out or copy the contents of the REGISTER.FRM file provided 
  113. in this package. Fill it out with the requested information and send it
  114. with check, money order or COD information to the address on the form itself
  115. or at the end of this documentation.  You may also send the information
  116. by NetMail or upload it to my board for COD orders.  
  117.  
  118. Upon receipt of your order you will be sent your registered key.  This
  119. will be done, via Net-Mail where applicable, upload to your BBS if 
  120. possible or by U.S. Mail.  All COD orders will be sent UPS or U.S. Mail. 
  121. ** Note: All COD fees will be added to the registration price.
  122.  
  123. *** Support ***
  124.  
  125. I will do my best to help with any problems encountered whether the game
  126. is registered or not. 
  127.  
  128. If you register this door, I will do my best to ensure that the registered
  129. key is sent promptly.  I will do the best I can to support this door and
  130. resolve any problems that might arise.  I can't guarantee to fix or resolve 
  131. all problems since there are so many different combinations of hardware, 
  132. software and system configurations being used, but I will do my best.
  133.  
  134. Support can be obtained by calling my BBS, by mail or though the FIDO Network.
  135. My current Node addresses are 1:105/314, 1:105/317, 1:105/330.  I also 
  136. participate in the FIDO echos DOORWARE, On-Line-Games and DOORGAMES as well as 
  137. the MSI-WILDCAT echo and will answer any questions addressed to me.  See the 
  138. SUPPORT.TXT file for more phone numbers and locations.
  139.  
  140. *** Features ***
  141.  
  142.        * Supports Wildcat 1.13, 2.x & 3.x, QuickBBS, PCBoard 14.X, Gap,
  143.          Spitfire, RBBS-PC, Remote Access, T.A.G., WWIV, Telegard,
  144.          Synchronet, TriBBS, VBBS, Ultra BBS, PowerBBS, Powerboard,
  145.          Renegade and Searchlight without the use of converters (and any 
  146.          others that use the same type info files).
  147.  
  148.        * Detects & Adjusts Screen For RIP Graphics. Eliminates the
  149.          scrunched screen appearance.
  150.         
  151.        * Makeup and Play ahead feature. (Requires Registered Key)
  152.  
  153.        * File Sharing & Record Locking for Networks & Multi-Tasking Systems.
  154.          (Feature requires Registered Key File.)
  155.  
  156.        * DESQview Detection & Awareness, which speeds program execution. 
  157.  
  158.        * Complete Setup Program to create the POKER-BN.CFG file.
  159.  
  160.        * Full ANSI Game.
  161.  
  162.        * Full Spilt-Screen Chat.
  163.  
  164.        * Sysop can Add or Decrease Time allowed in door with function keys.
  165.  
  166.        * Sysop can force user back to BBS with function key.
  167.  
  168.        * Mono selected colors for sharp picture when played in Mono Mode.
  169.  
  170.        * Built in bulletin generator for ANSI and ASCII bulletins (registered
  171.          version only).
  172.  
  173.        * Selectable In-depth Log File capability.
  174.  
  175.        * Carrier Drop Detection.
  176.  
  177.        * No Input In 5 Minutes, Time Out Detection.
  178.  
  179.        * Full BBS and FIDO Support (Demo or Registered)
  180.  
  181.        * Supports Comm Ports 1, 2, 3 & 4 And Non-Standard IRQ selection.
  182.  
  183.        * Supports Locked DTE Rate up to 115,200 Baud.
  184.  
  185.        * Supports FOSSIL detection
  186.  
  187.  
  188. *** Files In Archive ***
  189.  
  190. The following files are found either in the POKER-BN.ZIP or will be
  191. created during the runtime execution.
  192.  
  193. POKER-BN.EXE    <--- Executable Program.
  194.  
  195. POKER-BN.CFG  * <--- Sample Configuration File.
  196.  
  197. POKER-BN.DAT  * <--- Store User's Name, Last Play Date & Scores.
  198.  
  199. POKER-BN.HPS    <--- Ansi Mode Instructions Used By Program.
  200.  
  201. POKER-BN.DOC    <--- This File.
  202.  
  203. POKER-BN.SLB    <--- Screen Library.
  204.  
  205. POKER-BN.CHP  * <--- Last Month's Champion File.
  206.  
  207. POKER-BN.LOG  * <--- Game Activity Log.
  208.  
  209. DOOR.BAT        <--- Simple Sample Batch File For Door Execution.
  210.  
  211. REGISTER.FRM    <--- Registration Form For This And Other Doors.
  212.  
  213. HISTORY.TXT     <--- History file listing changes.
  214.  
  215. UPGRADE.TXT     <--- Explains what is needed to upgrade to new release
  216.                      from previous one.
  217.  
  218. POKER-BN.KEY    <--- Registration key. (Not needed for Evaluation mode)
  219.  
  220. SUPPORT.TXT     <--- List of boards carrying the latest version.
  221.  
  222. FOSSIL.TXT      <--- Information on Fossil support
  223.  
  224. * DENOTES that file is created during RUN-TIME.
  225.  
  226. POKER-BN.CHP:
  227.  
  228. This is the Last Month's Champion file. It contains the Champ's Name, Score,
  229. Date and How many games won that month. This file is automatically created
  230. when the game is first executed.
  231.  
  232. Deleting the POKER-BN.CHP file will cause the game to re-initialize
  233. itself. It will create a new POKER-BN.CHP file and a new POKER-BN.DAT file.
  234.  
  235.  
  236. *** Setup & Installation ***
  237.  
  238. Installation procedures are very simple if you have setup a live program in
  239. the past. First create a Sub-Directory for the door game and copy all the
  240. files from the POKER-BN.ZIP file into this directory.
  241.  
  242. Now execute the Setup program by typing POKER-BN SETUP with no parameters at
  243. the DOS prompt.  You must be in the directory with POKER-BN.EXE.
  244.  
  245. This will run the game's setup feature that will create a POKER-BN.CFG
  246. file. The setup program has complete on-line help so I will not duplicate
  247. it here.
  248.  
  249. Single Node Setup:  * See the section on Multi-Node for the changes
  250.                       required to line 1 and 6 in a Multi-Node setup.
  251.  
  252. This is what the POKER-BN.CFG contains when created (less the comments).
  253.  
  254.    1                        <-- COM PORT 1, 2, 3, 4 or &H###/#
  255.    N                        <-- Multi-Node 'Y' or 'N' 
  256.    COM-DAT BBS              <-- Name Of BBS
  257.    Mike Jordan              <-- Sysop's Full Name
  258.    DOOR.SYS                 <-- BBS Callers File
  259.    C:\WC30\WCWORK\NODE1\    <-- Drive & Path Of System's Caller File 
  260.    LOG                      <-- LOG to keep user log or NOLOG to disable
  261.    C:\BULLETIN\BULL99.BBS   <-- Drive\Path\BulletinName For Ansi Scores
  262.    C:\BULLETIN\BULL99.SCR   <-- Drive\Path\BulletinName For Ascii Scores
  263.    Wildcat                  <-- Type of BBS System You're Running See Note 1
  264.    Thanks For The Donations <-- 50 character dedication line
  265.    40                       <-- Games Allowed Per Day (1 to 99)
  266.    3                        <-- Number of Days allowed for Makeup 
  267.    10                       <-- Day that Makeup Games Start
  268.  
  269. NOTE 1: Valid System Callers files for each BBS system are as follows:
  270.  
  271.             Wildcat 3.X BBS System         <->  USERINFO.DAT or DOORS.SYS
  272.             Wildcat! 1.X & 2.X BBS System  <->  CALLINFO.BBS
  273.             QuickBBS System                <->  DORINFOx.DEF
  274.             RBBS-PC BBS System             <->  DORINFOx.DEF
  275.             Remote Access 1.x BBS System   <->  DORINFOx.DEF
  276.             Remote Access 2.x BBS System   <->  DORINFOx.DEF or DOORS.SYS
  277.             T.A.G. BBS System              <->  DORINFOx.DEF
  278.             PCBoard BBS System             <->  PCBOARD.SYS
  279.             Gap BBS System                 <->  DOORS.SYS
  280.             Spitfire BBS System            <->  SFDOORS.DAT
  281.  
  282. If you use another BBS System besides those listed, then you must use
  283. a converter to convert to one of the above caller file formats.
  284.  
  285. ** The Bulletin Drive\Path\Bulletin Name is designed to accept any valid
  286. Drive, Path and Filename of your choice. This allows each BBS system to
  287. configure for it's individual system.
  288.  
  289. Note 3: Line 11 (the dedication line) is required, even
  290. if it is a blank line.
  291.  
  292. *** Execution ***
  293.  
  294. Some BBS Systems call batch files and some run doors directly. If you
  295. don't know how to install a door on your particular BBS System then please
  296. see your BBS manual. This game merely needs the .CFG file name passed to it on
  297. the command line to operate, i.e. 
  298.  
  299.           POKER-BN.EXE POKER-BN.CFG
  300.  
  301. An example POKER-BN.BAT file could look like this:
  302.  
  303.      C:                         <-- Change to drive door is in
  304.      CD \POKER-BN               <-- Change to door directory
  305.      POKER-BN.EXE POKER-BN.CFG  <-- Execute door with config file
  306.      CD\BBS                     <-- Change back to BBS (may not be needed)
  307.      
  308.  
  309. Some systems (particular those with 486 PCs) may need to put in the 
  310. FOSSILOFF command.  This would look like this:
  311.  
  312.    POKER-BN.EXE POKER-BN.CFG FOSSILOFF
  313.  
  314.   Read the file FOSSIL.TXT included in the POKER-BN.ZIP file.
  315.  
  316. *** Multi-Node Use ***
  317.    
  318. Running this game on more than a single node requires a Multi-Node Key.
  319. When running in Evaluation mode, only one (1) Node will be able to access the
  320. door at a time. 
  321.  
  322. *** Environmental Variable Support ***
  323.  
  324.   Setting Ports using Environment Variables: If your running a Multi-Node
  325.   BBS system then you need to use environment variables. The game allows any
  326.   variable name to be used, but I will use the name WCPORTID just for
  327.   clarity. To specify the port using an environment variable you place the
  328.   name of the variable on this line wrapped in percent signs, ie %WCPORTID%.
  329.   This will tell the game to read this variable from the environment to get
  330.   the com port information. One limit to this is the syntax which must keep in
  331.   context when not using variables and this is when using non-standard port
  332.   addressing. When using non-standard port addressing the syntax must be the
  333.   same as explained above (ie. &H3F8/5). Some BBS packages use a different
  334.   variable for each of these. If this is your case then merely create another
  335.   by adding SET WCPORTID=&H3F8/5 to your BBS starting batch file and then use
  336.   %WCPORTID% as the com port of the configuration file. See Multi-Node Setup
  337.   below for more information.
  338.  
  339.  
  340.   The setup of Poker Bandit changes the way my previous doors are setup.
  341.   I now support and require the use of Environment Variables to supply the
  342.   game with the Com Port and Node Directory information. The game will
  343.   read any environment variable that you supply so names are not critical.
  344.  
  345.     The game now only reads the POKER-BN.CFG file and will not accept any
  346.   other name for the configuration file. So this is the file that will contain
  347.   the environment variables.
  348.  
  349.     The game requires only two pieces of information. This is the Com Port
  350.   and Node Directory information and these must be supplied with environment
  351.   variables.
  352.  
  353.     The environment variables is best set by your BBS's calling batch file.
  354.   This is the batch file that starts your BBS. If your running a Wildcat or
  355.   PCBoard BBS system then you probably already use the WCNODEID or PCBNODE
  356.   environment variables. These variables should work fine. If your using
  357.   another BBS system then you will probably have a similar variable. If not
  358.   just use the default ones used below in the example setup.
  359.  
  360.     Since I run Wildcat! software I am going to use WCPORTID and WCNODEID for 
  361.   my example of setting up on a Multi-Node system.  Also I will assume you need
  362.   to add the environment variables where in fact most cases they will already 
  363.   be in use.
  364.  
  365. Step 1:
  366.  
  367.     You will need to add the following lines to your batch files that start
  368.   your BBS. These lines should be located near the top of the file ahead
  369.   of any loop since they only need to be initialized one time:
  370.  
  371.      SET WCPORTID=1    This is your com port environment variable
  372.                        and assigns the com port for each node.
  373.  
  374.      SET WCNODEID=1    This is your node id environment variable
  375.                        and assigns the node number for each node.
  376.  
  377.     The WCPORTID is the tricky one of the two. Where the WCNODEID merely
  378.   assign the node number the WCPORTID may also have to assign a Non-Standard
  379.   Port address and IRQ. See above 'Line #1 Com Port' for explanation of this.
  380.  
  381.  
  382.     I will give a few examples setting the WCPORTID variable to try to avoid
  383.   confusion.
  384.  
  385.      SET WCPORTID=2         '--- Use Com Port #2 with IRQ 3 (standard)
  386.  
  387.      SET WCPORTID=&H3E8/5   '--- Use Com Port #3 with IRQ 5
  388.  
  389.  
  390.  
  391.     The environment variables are used on lines #1 and #6 of the configuration
  392.   file. Below is the first 7 lines of the configuration file with the
  393.   environment variables in place. See above if you need to see the complete
  394.   file. (exclude the comments).
  395.  
  396.     %WCPORTID%                <-- COM PORT 1, 2, 3, 4 or &H###/# or %WCPORTID%
  397.     Y                         <-- Make Sure This Is 'Y'es
  398.     Com-Dat BBS               <-- Name Of BBS
  399.     Mike Jordan               <-- Sysop's Full Name
  400.     DOOR.SYS                  <-- BBS Drop File
  401.     C:\BBS\NODE%WCNODEID%\    <-- Drive & Path Of Systems Caller File
  402.     LOG                       <-- LOG to keep user log or NOLOG to disable
  403.     ...etc...
  404.  
  405.   The game will read in these lines and will check lines #1 and #6 for
  406.   environment variables and thus read in their information. Line #6 assumes
  407.   the DOOR.SYS file will be placed in the C:\BBS\NODE1\ sub-directory if
  408.   WCNODEID equals 1.
  409.  
  410.    If you are already using environment variables with your current BBS setup
  411.   that meet the games need you can merely use those instead. 
  412.  
  413.   That's all there is too it.
  414.  
  415.  
  416.  
  417.     COMMAND Line Parameters: SETUP  LOCAL  ALIAS  FOSSIL  SPLIT
  418.  
  419.     This door has several command line parameters listed above. Below is
  420.     description for usage:
  421.  
  422.     SETUP       - Run's the Poker Bandit Setup program.
  423.  
  424.     LOCAL       - Used in conjunction with FILENAME.CFG LOCAL for executing
  425.                   the door in local only mode. For use from the DOS prompt
  426.                   only. Never use LOCAL in a BBS batch file.
  427.  
  428.     ALIAS       - Cause's the door to use Alias names on BBS System's
  429.                   which support the DOOR.SYS drop file.
  430.  
  431.     FOSSIL      - Cause's the door to use a previously installed fossil.
  432.  
  433.  
  434.     SPLIT       - Just a toy. This will cause the game to split the opening
  435.                   registration screen from the display.
  436.  
  437.     In some cases more than one option will be needed, such a case being
  438.   when using a fossil and also using alias names. The command line to execute
  439.   the game would look like this:
  440.  
  441.                            POKER-BN.EXE FOSSIL ALIAS
  442.  
  443.                       Order of the option does not matter.
  444.  
  445.  
  446. *** Notes Of Interest ***
  447.  
  448. This game does not require a monitoring program for dropped carrier as
  449. it automatically detects this and exits back to the BBS.
  450.  
  451. This door DOES NOT require any runtime modules. It will run
  452. as is without aid from outside utilities.
  453.  
  454.  
  455. *** Technical Support ***
  456.  
  457. If you have problems with this door game you can contact me through
  458. my BBS at the numbers listed below, or though my FIDO addresses 1:105/314,
  459. 1:105/317 or 1:105/330. 
  460.  
  461. BBS Phone:       Com-Dat
  462.            Node 1 - (503) 681-0543 (14.4 v32) 
  463.            Node 2 - (503) 640-0278 (14.4 v32)
  464.            Node 3 - (503) 681-8324 (Zoom 33.6)
  465.            FIDO 1:105/314 (14.4 v32)
  466.            FIDO 1:105/317 (14.4 V32) 
  467.            FIDO 1:105/330 (Zoom 33.6)
  468.            E-Mail: mike.jordan@comm-dat.com
  469.            24 hour - First time callers have access to
  470.                      door programs.
  471.  
  472. Mailing Address: Mike Jordan 
  473.                  2001 NE Hyde St.
  474.                  Hillsboro, OR.  97124
  475.                  Support & Orders Voice: (503) 693-7068
  476.  
  477. *** Ordering Information ***
  478.  
  479. Please see the file REGISTER.FRM file in this package for ordering
  480. information.
  481.  
  482. *** Updates To M & S Doors ***
  483.  
  484. Updates to any M & S Software product may be downloaded from any Distribution
  485. BBS.  My intent is to always supply updates FREE unless major revisions are 
  486. made to the software, in which case a small update fee will be charged.
  487.  
  488. *** Distribution ***
  489.  
  490. You are free, in fact encouraged, to distribute the SHAREWARE version
  491. of the door game provided that all files contained in the original
  492. archive are distributed in their original unmodified state.
  493.  
  494. The Registered Key MAY NOT be distributed in any form.
  495.  
  496. *** Acknowledgements ***
  497.  
  498.               Wildcat BBS System - Mustang Software
  499.               GAP Communications - The GAP Development Company
  500.               PCBoard - Clark Development Company, Inc.
  501.               Spitfire - Mike Woltz, Buffalo Creek Software
  502.               QuickBBS - The QuickBBS Group, Inc
  503.               Remote Access - Wantree Development
  504.  
  505. *** Special Acknowledgement ***
  506.  
  507. I would like to give a very big thank you to the person that has done the
  508. most to make this game (plus all my past and hopefully future door games)
  509. possible.  This person is Rusty Johnson of JNS Software. Rusty has released
  510. many excellent door games into the BBS arena and if you haven't taken a look
  511. at any of them you are missing out on some of THE best door games available.
  512. Rusty and I have known each other for several years now and have helped each
  513. other many times and this is one case where giving has been rewarded tenfold. 
  514. I'm glad to be able to call Rusty my friend.  Thanks Rusty.
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521. Poker Bandit Copyright 1993 - 1997 by M & S Software